Appointment Scheduling Process API - Implementation Template
Setup guide
Importing templates into Anypoint Studio
- In Studio, click the Exchange X icon in the upper left of the taskbar.
- Log in with your Anypoint Platform credentials.
- Search for the template.
- Click Open.
Running templates in Anypoint Studio
After you import your template into Studio, use the following configuration steps to run it.
Appointment Scheduling Configuration
mule.env- sets the environment where the application is to be deployed. For a studio deployment, the recommended mule.env value islocalmule.key- sets the encryption password to be used for encrypting secure properties. Update as neededapi.baseurl- sets the base url of the api. Replace/override as needed when deploying to any environment. Default value ishttps://localhost:8082/api, whenmule.envislocalprimary- sets the primary system api for the API. It should be configured inconfig-<mule.env>.yamlfilecerner.baseurl- sets the base url for Cerner Workflow System API. It should be configured inconfig-<mule.env>.yamlfilecerner.source- set the source for validating {sourceSystem} uri parameter. Update the scopes as required for the operations. It should be configured inconfig-<mule.env>.yamlfile. Default value is "Cerner"cerner.serviceTypeToken- sets the serviceType url for Appointment/Slot search. The parameter includes the systemId created as part of Cerner Sys API setup. The systemId is part of the tokenUrl/baseUrl in the system APi. It should be configured inconfig.<mule.env>.yaml. Examplehttps://fhir.cerner.com/<systemId>/codeSet/14249epic.baseurl- sets the base url for Epic Workflow System API. It should be configured inconfig-<mule.env>.yamlfileepic.source- set the source for validating {sourceSystem} uri parameter. Update the scopes as required for the operations. It should be configured inconfig-<mule.env>.yamlfile. Default value is "Epic"
Deploy the system APIs referenced by the process API, which are:
- Epic — (referred to as the Epic API)
- Cerner — (referred to as the Cerner API) System API for Cerner EMR system
HTTPS Configuration
https.host— sets the service host interface. It should be configured inconfig-<mule.env>.yamlfile. (Defaults to 0.0.0.0 for all interfaces).https.port— sets the HTTPS service port number. It should be configured inconfig-<mule.env>.yamlfile. (Default 8082).- TLS Configuration - Keystore properties setup:
keystore.alias- sets the alias to the keystore. It should be configured inconfig-<mule.env>.yamlfile.keystore.path- sets the path to the key file. Key should be available in /src/main/resources/keystore. It should be configured inconfig-<mule.env>.yamlfile.keystore.keypass— sets keystore keypass to support HTTPS operation. It should be encrypted and configured inconfig-secured-<mule.env>.yamlfile.keystore.password— sets keystore password to support HTTPS operation. It should be encrypted and configured inconfig-secured-<mule.env>.yamlfile.
Please refer to the attached link on how to generate the Keystore.
Run it
- Right-click the template project folder.
- Hover your mouse over 'Run as'.
- Click Mule Application (configure).
- Inside the dialog, select Environment and set the variable mule.env to the appropriate value (e.g., dev or local).
- Inside the dialog, select Environment and set the variable mule.key to the property encryption key that you used to encrypt your secure properties.
- Click Run.
Deployment instructions for CloudHub using provided scripts
Ensure the Maven profile CloudHub-DEV has been properly configured in your settings.xml file. Reference can be found by downloading the Accelerator Setup Guide asset. Additional instructions are available in Accelerator Setup Guide - Configuring the Accelerator Build section.
Update the config-dev.yaml properties appropriately and then use one of the following scripts to deploy the application to CloudHub:
- packageDeploy.sh or deployOnly.sh (Mac/Linux)
- packageDeploy.cmd or deployOnly.cmd (Windows)
Testing
- Use Advanced Rest Client or Postman to send request over HTTPS. The template includes a postman collection in
src/test/resourcesfolder. Update the collection variable(s) after successful import.